home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
keyb
/
stfkey40.zip
/
STUFFKEY.DOC
< prev
next >
Wrap
Text File
|
1992-11-13
|
46KB
|
1,209 lines
Documentation
for
STUFFIT 3.21 / STUFFKEY 4.00
------------------------------------------
Stuffit Copyright (c) Terje Mathison 1990 - 1992
Stuffkey Enhancements Copyright (c) Juergen Geist 1992
------------------------------------------------------
Although copyrighted, the described programs are a
'labor of love'
and completely free!
Stuffkey.doc Last updated by Juergen Geist 1992 November 16.
Stuffkey 4.00 has the following enhancements over 3.30
- {IfSucc}/{Else}/{Endif} logic using ~{Timeout} on F{Find}
and P{Prompt} commands.
- A {Stop} command.
- Improved error message pointers.
Stuffkey.doc Last updated by Juergen Geist 1992 October 17.
Stuffit 3.21 was written by Terje Mathison.
Stuffkey 3.30, by Juergen Geist, is Terje's code with the
following enhancements:
- Error messages including error location pointer.
- Improved background time handling in Windows, Desqview,
etc.
- Timer resolution down to timer ticks, 1/18 sec.
- A time out feature for Prompt and Find commands; the
first step to adding If/Then/Else login.
- A simplified Prompt command, i.e.: p"text".
It is hoped that Terje will incorporate these mods; to avoid
confusion until/if he does, Stuffkey will exist. All Stuffkey
changes are documented here and in the .asm file. The 'zip'
file should contain both versions of the .asm and .com files.
StuffIt.Doc Last-1 update by Roedy Green 1992 June 21
Table of Contents
-----------------
** To be created soon!
PURPOSE
-------
Stuffit 3.21 is a utility that automates the keyboard. You can
provide a script of keystrokes and Stuffit will automatically
type them into your application programs. What makes Stuffit
different from other similar keyboard macro programs is:
1. The keyboard remains fully functional the entire time
for additional manual input or correction.
2. Stuffit works with intractable programs that throw away
keystrokes, bypass DOS etc.
3. Stuffit watches the screen. It does not just type
blindly.
4 Stuffkey 4.0 supports if/else/endif logic based on what it
finds on the screen.
5. Stuffit can handle large scripts, up to 64K.
6. Stuffit lets you generate more possible keystroke
chords than other similar products.
7. Assembler source code is provided, giving you the
option of adding new features to the program.
COMMAND LINE PARAMETERS IN A NUTSHELL
+0 or + Delay until the application has used up all the
keystrokes in the type-ahead buffer. This is
useful for applications that throw away keystrokes
fed to it too quickly. This is also a handy way
to flush any pending (uneaten) codes from a
previous invocation of StuffIt. e.g.: StuffIt +0
empties StuffIt's internal buffer. Note + all
by itself defaults to +0.
+hh:mm:ss time delay. (hours and minutes optional) +4 means
wait 4 seconds (must be 0..59). +2:4 means wait 2
minutes and 4 seconds. +5:: means wait 5 hours.
Represented internally as {Wait}. Often you want
a +5 or so at the start of your script to give the
program you are stuffing 5 seconds to load and get
ready for a keystroke. The timing starts relative
to when STUFFIT runs, not from when the following
application requests its first keystroke.
+.tt time delay as above, but in timer ticks, or
1/18 second resolution. tt can range from 1 to
18. Note this can't be mixed with hh:mm:ss,
etc. Useful when you need just a bit of delay
between keystrokes. +.6 will delay 1/3 second.
(**-Stuffkey-**)
=hh:mm:ss delay until a specific time of day (24 hour
format) (hours and minutes optional). =16:00:00
means wait till 4 PM. =00:00:00 means wait till
midnight. =0 also means wait till midnight.
Represented internally as {AtTime}. Be careful!
=04:00 would mean 4 minutes after midnight!
~hh:mm:ss {TimeOut} next function, i.e., {Prompt}, {Find} in
supplied time. Timer tick format is ok. i.e. ~.15.
This allows script to continue on a "not found"
condition. Stuffkey V.4.00 adds the ability to test
the results of P {Prompt} and F {Find} commands. See
{IfSucc}, {Else} and {Endif} for details.
(**-Stuffkey-**).
nn stuff a given character code e.g. 27 for Escape,
13 for Enter Only ASCII decimal numerics are
accepted. See ASCII code chart in your IBM AT
tech Reference. You may also use the mnemonics
e.g. {Esc} for 27. Note that you may use either
[] or {} but you must use [{], [}], {[} and {]}
for the braces and brackets themselves.
@nn stuff an extended code preceded by a null. Only
numerics are accepted. You may use the numeric
forms or the mnemonics e.g. @68 or {F10}, @73 or
{PgUp} See table following for the common codes.
If you cannot find an mnemonic, you will have to
use the numeric form.
cc:ss specify both the decimal character and its scan
code e.g. 43:74 to mean the Plus key on the
numeric keypad, rather than the ordinary plus key.
See table following for common pairs. You may use
the numeric forms or the mnemonics e.g. 10:28 or
{^Cr} for Control-Enter. If you cannot find a
mnemonic, you will have to use the numeric pair
form.
'xxxx' Stuff the characters between the quote marks. The
string itself may not contain 's.
"xxxx" Stuff the characters between the double quote
marks. The string itself may not contain "s.
F70,20,5,01,"Please enter your phone number"
The absolute FIND command. Wait patiently for
text to appear at col, row, length, attribute.
The attribute is optional. StuffIt searches
starting at column 70, row 20 for the string
"Please enter your phone number". It waits until
the string appears. The 5 means allow some slop.
The string may START anywhere in a window within 5
characters to the right of the specified starting
point. It does not mean the whole string must FIT
in a window five characters wide. The slop may
wrap around from one line to the next. See the
notes below on Stuffit's co-ordinate system, where
1,1 is the upper left corner. The 01 is a rarely
used feature. It means, the match only counts if
the string is displayed with decimal video
attribute "01". If you leave out the 01, leave
out its comma as well. Represented internally as
{Find}.
(**-Stuffkey-**) Provides the ~ or {TimeOut} feature
to enable escaping from an "unfound" condition.
P10,1,5,01,"Please enter your phone number"
The relative PROMPT command. Wait patiently for
text to appear at relative col, row, length,
attribute. The attribute is optional. Stuffit
searches for the string "Please enter your phone
number" st